跳到主要内容

SmartAgent Version 10.0.3

发布日期：2026 年 5 月 11 日

版本概述​

SmartAgent 10.0.3 引入 应用探针运行时数据隔离模式，并集成 JavaAgent 9.13.1、DotnetAgent 6.16.0、PHPAgent 8.6.0、PythonAgent 8.7.3、NginxAgent 3.9.1、SDKAgent 5.15.1 、GoAgent 5.0.3 等子探针升级；同时增强 LLM 大模型监控、Windows 日志采集 能力，并优化镜像、权限与容器注入等通用能力。

  • ✨ 应用探针运行时数据隔离：新增 --enable-user-data-isolation 安装参数，应用探针运行时数据 (logs/cache) 支持按用户隔离存储

  • ✨ JavaAgent 9.13.1：优化 JFR、UEM HTML 注入、dubbo/jedis/HBase 采集；修复 thrift 请求头污染、ejb.MessageDriven 及 Allatori 混淆器生成的类兼容问题

  • ✨ PythonAgent 8.7.3 / SDKAgent 5.15.1：支持 LLM 大模型监控（openai、langchain、dify、mcp 等）

  • ✨ DotnetAgent 6.16.0：新增 TopShelf 场景支持

  • ✨ GoAgent 5.0.3: 修复go1.19及以下版本http调用链无法采集问题

  • ✨ logsAgent 3.0.1（Windows）：支持采集 Windows Event Logs 及日志文件编码识别

  • 🔧 通用优化：镜像升级至 1.1.5；非 root 安装日志/缓存权限收窄；nginx 探针自动注入版本屏蔽调整

升级建议
  • 多用户共享主机或需 按用户隔离探针运行时数据 的环境，建议升级并评估 --enable-user-data-isolation（从旧版或非隔离模式升级后，已注入进程需重启）；
  • 使用 LLM 框架（openai/langchain/dify/mcp）、TopShelf、非 root podman 容器 或 Windows 日志采集 的场景应优先升级。

Linux x86_64 系统​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.13.1
  • DotnetAgent：6.16.0
  • PHPAgent：8.6.0
  • PythonAgent：8.7.3
  • NodejsAgent：7.2.0
  • NginxAgent: 3.9.1
  • ApacheAgent：3.4.0
  • SDKAgent：5.15.1
  • GoAgent：5.0.3
  • logsAgent：3.0.1

新增功能​

  1. 支持应用探针运行时数据隔离模式（从旧版探针或从非隔离模式升级到隔离模式时，已注入探针的进程需要重启才能正常采集数据）：
    • 新增安装参数 --enable-user-data-isolation（仅支持 Linux Root 安装场景）；
    • 应用探针运行时数据（logs/cache）支持按用户隔离存储。

功能优化与修复​

1. JavaAgent 升级至 9.13.1​

功能优化

  • 优化 JFR 临时目录默认为 java.io.tmpdir，避免使用中被删除影响 JFR；
  • 优化 UEM HTML 注入边界场景（已存在脚本时跳过注入、基于响应头控制注入）；
  • 日志与目录权限和路径调整：文件改为 640、目录改为 750，日志文件命名后缀调整为 _{pid}_{uid}.log；
  • 开源组件库漏洞修复；
  • 优化 dubbo-2.7.0～3.3.6 异步标识及耗时统计；
  • 优化 jedis-4.x 耗时统计；
  • 优化 HBase 采集次数统计。

修复 Bug

  • 修复 thrift 请求头污染导致下游 HTTP 请求头非法问题（影响范围：JavaAgent 8.0.0～9.12.4，对应 SmartAgent 6.0.0～9.12.6）。
  • 修复 ejb.MessageDriven 兼容问题（影响范围：JavaAgent 8.0.0～9.12.4，对应 SmartAgent 6.0.0～9.12.6）。
  • 修复 Allatori 混淆器生成的类兼容问题（影响范围：JavaAgent 8.0.0～9.12.4，对应 SmartAgent 6.0.0～9.12.6）。

2. DotnetAgent 升级至 6.16.0​

新增功能

  • 新增 TopShelf 场景支持（支持范围：模块版本 TopShelf 4.3.0；框架版本 .NET 5.0/6.0/7.0/8.0）。

功能优化

  • 日志文件权限由 0666 调整为 0640，日志目录权限由 0777 调整为 0750。

3. PHPAgent 升级至 8.6.0​

新增功能

  • 支持运行时数据隔离模式。

4. PythonAgent 升级至 8.7.3​

新增功能

  • 支持 LLM 大模型监控（openai 2.26.0、2.31.0；langchain 1.2.10、1.2.15；dify 1.4.3、1.11.0、1.11.2；mcp 1.25.0、1.27.0）；
  • 支持运行时数据隔离模式。

修复 Bug

  • 修复 httpx 框架流式响应时间获取（影响范围：PythonAgent 8.4.0～8.7.2，对应 SmartAgent 9.6.0～10.0.1）。
  • 修复 langchain agent 节点未判断 llm enable 问题（影响范围：PythonAgent 8.7.0～8.7.2，对应 SmartAgent 10.0.0～10.0.1）。

5. NodejsAgent 升级至 7.2.0​

功能优化

  • 支持运行时数据隔离模式。

6. NginxAgent 升级至 3.9.1​

新增功能

  • 支持运行时数据隔离模式；
  • 支持 fastcgi_pass 使用 unix sock 通信。

7. SDKAgent 升级至 5.15.1​

新增功能

  • 支持 LLM 大模型监控。

功能优化

  • 支持运行时数据隔离模式；
  • 业务指标调用链数统计初始化规范化。

8. GoAgent 升级至 5.0.3​

修复 Bug

  • 修复 go1.19 及以下版本 http 调用链无法采集问题（影响范围：GoAgent 5.0.1～5.0.2，对应 SmartAgent 9.12.3～10.0.1）。

9. nginx 探针自动注入版本屏蔽调整​

  • 屏蔽版本 > v1.29.3；
  • 屏蔽版本 >= v1.28.1 且 < v1.29.0。

10. 镜像与权限​

  • 更新镜像至 1.1.5：禁止指定安装目录或运行时目录至 /tmp 下；
  • 非 root 安装日志、缓存权限收窄（logs/* 和 cache/* 应用探针目录权限由 777 调整为 775）。如需支持跨用户组监控，需手动将上述目录权限修改为 777：
chmod 777 logs/*
chmod 777 cache/*
chmod 777 cache/java/dump

11. SmartAgent 自身修复​

修复 Bug

  • 修复非 root podman 容器无法注入/无法监控问题（影响范围：7.5.0～9.12.*，仅支持非隔离模式下注入非 root podman 容器）。
  • 修复进程频繁崩溃时未能正确识别探针进入禁止监控状态原因的问题。

Linux ARM64 系统​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.13.1
  • DotnetAgent：6.16.0
  • PHPAgent：8.6.0
  • PythonAgent：8.7.3
  • NginxAgent: 3.9.1
  • SDKAgent：5.15.1
  • GoAgent：5.0.3
  • logsAgent：3.0.1

新增功能​

  1. 支持应用探针运行时数据隔离模式（同 Linux x86_64）。

功能优化与修复​

平台说明

本平台的功能更新与 Linux x86_64 系统基本一致，主要差异为探针支持范围。具体包括：

功能优化与修复

  • 同 Linux x86_64（含 JavaAgent、DotnetAgent、PHPAgent、PythonAgent、NginxAgent、SDKAgent、GoAgent 升级及镜像、权限、nginx 版本屏蔽等相关更新）

平台差异

  • aarch64 平台暂时屏蔽 PythonAgent profiling 能力（存在缺陷，可能触发未捕获异常导致应用退出）

注意事项

  • ARM64 平台暂不支持 NodejsAgent、ApacheAgent

Windows x86_64 平台​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.13.1
  • DotnetAgent：6.16.0
  • logsAgent：3.0.1

功能优化与修复​

1. JavaAgent 升级至 9.13.1​

功能优化

  • 优化 JFR 临时目录默认为 java.io.tmpdir，避免使用中被删除影响 JFR；
  • 优化 UEM HTML 注入边界场景（已存在脚本时跳过注入、基于响应头控制注入）；
  • 开源组件库漏洞修复；
  • 优化 dubbo-2.7.0～3.3.6 异步标识及耗时统计；
  • 优化 jedis-4.x 耗时统计；
  • 优化 HBase 采集次数统计。

修复 Bug

  • 修复 thrift 请求头污染导致下游 HTTP 请求头非法问题（影响范围：JavaAgent 8.0.0～9.12.4，对应 SmartAgent 6.0.0～9.12.6）。
  • 修复 ejb.MessageDriven 兼容问题（影响范围：JavaAgent 8.0.0～9.12.4，对应 SmartAgent 6.0.0～9.12.6）。
  • 修复 Allatori 混淆器生成的类兼容问题（影响范围：JavaAgent 8.0.0～9.12.4，对应 SmartAgent 6.0.0～9.12.6）。

2. DotnetAgent 升级至 6.16.0​

新增功能

  • 新增 TopShelf 场景支持（支持范围：模块版本 TopShelf 4.3.0；框架版本 NetFramework 4.5.2/4.6/4.6.1/4.7/4.8、.NET 5.0/6.0/7.0/8.0）。

3. logsAgent 升级至 3.0.1​

新增功能

  • 支持采集 Windows Event Logs；
  • 支持日志文件编码识别（UTF-8、GBK）。

4. Windows 平台 logsAgent 集成​

  • 集成 Windows 版本 logsAgent，完善 Windows 平台可观测能力。

5. SmartAgent 自身修复​

修复 Bug

  • 修复 Windows Nodejs 进程组识别错误问题。

兼容性说明​

平台兼容性​

操作系统支持架构最低 One 版本
Linuxx86_64V2.2.2
LinuxARM64V2.2.2
Windowsx86_64V2.2.2